package com.mapaower.job.service;

import com.mapaower.job.entity.Job;
import java.util.List;
import java.util.Optional;

/**
 * 工作职位服务接口
 * 定义工作职位相关的业务逻辑方法
 */
public interface JobService {

    /**
     * 创建新职位
     * @param job 职位信息
     * @return 创建后的职位
     */
    Job createJob(Job job);

    /**
     * 更新职位信息
     * @param job 职位信息
     * @return 更新后的职位
     */
    Job updateJob(Job job);

    /**
     * 根据ID查找职位
     * @param id 职位ID
     * @return 职位信息
     */
    Optional<Job> getJobById(Long id);

    /**
     * 根据创建者ID查找职位列表
     * @param creatorId 创建者ID
     * @return 职位列表
     */
    List<Job> getJobsByCreatorId(Long creatorId);

    /**
     * 获取所有开放的职位列表
     * @return 职位列表
     */
    List<Job> getOpenJobs();

    /**
     * 获取所有远程工作职位
     * @return 职位列表
     */
    List<Job> getRemoteJobs();

    /**
     * 根据职位类型和状态查找职位
     * @param type 职位类型
     * @param status 职位状态
     * @return 职位列表
     */
    List<Job> getJobsByTypeAndStatus(Job.JobType type, Job.JobStatus status);

    /**
     * 搜索职位
     * @param keyword 搜索关键词
     * @return 职位列表
     */
    List<Job> searchJobs(String keyword);

    /**
     * 更新职位状态
     * @param id 职位ID
     * @param status 新职位状态
     * @return 更新后的职位
     */
    Job updateJobStatus(Long id, Job.JobStatus status);

    /**
     * 删除职位
     * @param id 职位ID
     */
    void deleteJob(Long id);
}